home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / OpenGL-GLC / glcmeasurecountedstring.z / glcmeasurecountedstring
Text File  |  1998-10-20  |  5KB  |  67 lines
  1.  
  2.  
  3.  
  4. ggggllllccccMMMMeeeeaaaassssuuuurrrreeeeCCCCoooouuuunnnntttteeeeddddSSSSttttrrrriiiinnnngggg((((3333GGGG))))                          OOOOppppeeeennnnGGGGLLLL CCCChhhhaaaarrrraaaacccctttteeeerrrr RRRReeeennnnddddeeeerrrreeeerrrr
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllccccMMMMeeeeaaaassssuuuurrrreeeeCCCCoooouuuunnnntttteeeeddddSSSSttttrrrriiiinnnngggg - store a string of specified length in
  10.      measurement buffer
  11.  
  12.  
  13. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      GLint ggggllllccccMMMMeeeeaaaassssuuuurrrreeeeCCCCoooouuuunnnntttteeeeddddSSSSttttrrrriiiinnnngggg( GLboolean _i_n_M_e_a_s_u_r_e_C_h_a_r_s,
  15.                                     GLint _i_n_C_o_u_n_t,
  16.                                     const GLCchar *_i_n_S_t_r_i_n_g )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _i_n_M_e_a_s_u_r_e_C_h_a_r_s  Specifies whether to compute metrics only for the string
  21.                      or for the characters as well.
  22.  
  23.      _i_n_C_o_u_n_t         Specifies the number of elements to measure, starting at
  24.                      the first element.
  25.  
  26.      _i_n_S_t_r_i_n_g        Specifies the string to be measured.
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      ggggllllccccMMMMeeeeaaaassssuuuurrrreeeeCCCCoooouuuunnnntttteeeeddddSSSSttttrrrriiiinnnngggg is identical to ggggllllccccRRRReeeennnnddddeeeerrrrCCCCoooouuuunnnntttteeeeddddSSSSttttrrrriiiinnnngggg but
  30.      instead of rendering a string, the command measures the resulting layout
  31.      and stores the measurements in the GLC measurement buffer.
  32.  
  33.      The string consists of the first _i_n_C_o_u_n_t elements of the array _i_n_S_t_r_i_n_g.
  34.      The array does not have to be zero terminated.
  35.  
  36.      If the value of _i_n_M_e_a_s_u_r_e_C_h_a_r_s is GGGGLLLL____TTTTRRRRUUUUEEEE, ggggllllccccMMMMeeeeaaaassssuuuurrrreeeeCCCCoooouuuunnnntttteeeeddddSSSSttttrrrriiiinnnngggg
  37.      computes metrics for each character and for the overall string. It
  38.      assigns the value _i_n_C_o_u_n_t to the variable GGGGLLLLCCCC____MMMMEEEEAAAASSSSUUUURRRREEEEDDDD____CCCCHHHHAAAARRRRAAAACCCCTTTTEEEERRRR____CCCCOOOOUUUUNNNNTTTT.
  39.      Otherwise, ggggllllccccMMMMeeeeaaaassssuuuurrrreeeeCCCCoooouuuunnnntttteeeeddddSSSSttttrrrriiiinnnngggg computes metrics only for the overall
  40.      string, and it assigns the value zero to GGGGLLLLCCCC____MMMMEEEEAAAASSSSUUUURRRREEEEDDDD____CCCCHHHHAAAARRRRAAAACCCCTTTTEEEERRRR____CCCCOOOOUUUUNNNNTTTT.
  41.  
  42.      If ggggllllccccMMMMeeeeaaaassssuuuurrrreeeeCCCCoooouuuunnnntttteeeeddddSSSSttttrrrriiiinnnngggg does not raise an error, its return value is
  43.      the value of _i_n_M_e_a_s_u_r_e_C_h_a_r_s GGGGLLLLCCCC____MMMMEEEEAAAASSSSUUUURRRREEEEDDDD____CCCCHHHHAAAARRRRAAAACCCCTTTTEEEERRRR____CCCCOOOOUUUUNNNNTTTT.
  44.  
  45. EEEERRRRRRRROOOORRRRSSSS
  46.      GGGGLLLLCCCC____SSSSTTTTAAAATTTTEEEE____EEEERRRRRRRROOOORRRR is generated if the issuing thread has no current GLC
  47.      context.
  48.  
  49. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  50.      ggggllllccccGGGGeeeettttSSSSttttrrrriiiinnnnggggCCCChhhhaaaarrrrMMMMeeeettttrrrriiiicccc
  51.      ggggllllccccGGGGeeeettttSSSSttttrrrriiiinnnnggggMMMMeeeettttrrrriiiicccc
  52.      ggggllllccccGGGGeeeettttiiii with argument GGGGLLLLCCCC____MMMMEEEEAAAASSSSUUUURRRREEEEDDDD____CCCCHHHHAAAARRRR____CCCCOOOOUUUUNNNNTTTT
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.